filechooser: Correct an annotation
authorMatthias Clasen <mclasen@redhat.com>
Mon, 27 Apr 2020 04:35:47 +0000 (00:35 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Mon, 27 Apr 2020 04:35:47 +0000 (00:35 -0400)
Clarify that gtk_file_chooser_add_filter is only taking
ownership of a floating reference, which translates to
"transfer none", not "transfer full".

Fixes: #2016
gtk/gtkfilechooser.c

index 549c56279bf6cfed26e00b1cd54210889a1df17b..58709d9e6721a7eeb016678fe6ccfcd1497c3f2f 100644 (file)
@@ -647,14 +647,14 @@ gtk_file_chooser_remove_shortcut_folder (GtkFileChooser  *chooser,
 /**
  * gtk_file_chooser_add_filter:
  * @chooser: a #GtkFileChooser
- * @filter: (transfer full): a #GtkFileFilter
+ * @filter: (transfer none): a #GtkFileFilter
  * 
  * Adds @filter to the list of filters that the user can select between.
  * When a filter is selected, only files that are passed by that
  * filter are displayed. 
  * 
- * Note that the @chooser takes ownership of the filter, so you have to 
- * ref and sink it if you want to keep a reference.
+ * Note that the @chooser takes ownership of the filter if it is floating,
+ * so you have to ref and sink it if you want to keep a reference.
  **/
 void
 gtk_file_chooser_add_filter (GtkFileChooser *chooser,